A182  017  INTEGRATED  INFORMATION  SUPPORT  SVSTEH  (IISS)  VOLUME  S  1/1 
COMMON  DATA  MODEL  S  <U>  GENERAL  ELECTRIC  CO 
SCHENECTADV  NV  PRODUCTION  RESOURCES  CONSU 
UNCLASSIFIED  J  L  ALTHOFF  ET  AL  01  NOV  85  PS-620141220  F/G  12/5  NL 


AD-A182  017 


AFWAL-TR-86-4006 


Volume  V  -  Common  Data  Model  Subsystem 

Part  31  -  File  Utilities  Product  Specification 


General  Electric  Company 
Production  Resources  Consulting 
One  River  Road 
Schenectady .  New  York  12345 


Final  Report  for  Period  22  September  1980  -  31  July  1985 
November  1985 


Approved  for  public  release;  distribution  is  unlimited. 


MATERIALS  LABORATORY 

AIR  FORCE  WRIGHT  AERONAUTICAL  LABORATORIES 
AIR  FORCE  SYSTEMS  COMMAND 
VRIGHT-PATTERSON  AFB ,  OH  45433-6533 


NOTICE 


When  Government  drawings  specifications,  or  other  data  are  used  for  any  purpose  other  than 
m  connection  with  a  definitely  related  Government  procurement  operation,  the  United  States 
Government  thereby  incurs  no  responsibility  nor  any  obligation  whatsoever ;  and  the  fact  that  the 
government  may  have  formulated,  furnished,  or  in  any  way  supplied  the  said  drawings, 
specifications,  or  other  data,  is  not  to  be  regarded  by  implication  or  otherwise  as  in  any 
manner  licensing  the  holder  or  any  other  person  or  corporation,  or  conveying  any  rights  or 
permission  to  manufacture  use.  or  sell  any  patented  invention  that  may  in  any  way  be  related 
thereto. 

This  report  has  been  reviewed  by  the  Office  of  Public  Affairs  (ASD/PA)  and  is  releasable  to  the 
National  Technical  information  Service  (NTlSi  At  NTIS.  it  will  be  available  to  the  general 
public,  including  foreign  nations 


This  technical  report/has  been  reviewed  and  is  approved  for  publication. 


OacUittflad 

SICv»  Tv  c.tu  *'t*T*0*.  O'  TmS  »AOI 


dr/ 


U  M»0*T|iCvM«  CwAU  »<C AT*©* 

P&clutifltd 


REPORT  DOCUMENTATION  PAGE 


1*  •tSTft.CtlVt  MA»«.lNCt 


]>  »ICW«lT»  [kiU  '»  iCATiON  AUT*0»lTV 


2»  Otei-*8S'*iCATiO*>/DOmr'vCAAO<*C  kCnlOWLl 


A.  'U'O'Mmc  OACAMiZaTiO*  AHOAT  huuKMl 


3  O'STAlki/TlO*  AVAiuASiklTV  O'  A|'OAT 


Approved  for  public  release; 
distribution  is  unliaited. 


(a  hivl  O'  A|*'OAMiNC  OACAAitATiOM 

Cttirsl  Electric  Company 
Production  Resources  Consulting 


It  AOCAtU  (Cm.  la*  Mb/fMij 


1  Elver  losd 
Schenectady .  IT  12345 


I  *»OMTO«'  AG  OACANltATlQta  Ai  'OST  NwWSt  Altl 

AFVAL-TR-86-4006  Vol  V.  Part  SI 


7*.  A  AMI  01  MOHlTOAiNb  OAOAWlXATlON 
AFVAL/HLTC 


7a  AODACU  (Cm.  Smm  an#  Zlf  Cmatt 

VPAFB.  OH  45433-6533 


t*  N  a  Ml  O*  *UA0iA0JS70Ak0*iA0 
OA&ANiZATiO* 

Hater tals  Laboratory 

Air  Force  Syctems  Command ,  USAF 


•  FAOCUACMf «T  IttSTAUUf hT  lOtATltlCATtO*  WMMSI  A 

F3361 5-S0-C-S155 


Ac  *00*122  iCttw.  fma  *m«  Ilf  Csmi 

Wright -Patterson  ATE.  Ohio  45433 


II.  TiTal  timtimSt  knnf*  CamiAmwi 

(See  Reverse) 


lie  kOuACI  O'  'unOiNCKOS 

PAOCAAM 

PAOaICT 

TASK 

worn*  wait 

■  klMSNT  mo. 

mo. 

MO. 

MO. 

waour 

7500 

62 

01 

is.  ecesoAAa  autmosoi 

Bradley,  W.  J.  and  Althoff.  J-  t- 


iSa  Tvmi  o»  At'OAT  IDaTiuI  COVIMO 

Piaal  Technical  Mycrt  I  82  Sept  1»S0  •  91  *«ly  1BSS 


14  OaTI  07  At'OAT  !Yr.M»  .Per/  lit  7*01  COWNT 

108S  November  I  87 


ik  8w»»atMiA7A*v  moTATi&i>  The  computer  software  contained  herein  are  theoretical  and/or 

„  , _ .  __nl  references  that  in  ao  way  reflect  Air  Force-owned  or  -developed 

JCAB  Project  Priority  «201  OOBputer  BOftyare. 


C Otari  cootk 


0005 


IS  aatraACT  iCmmu—  mm  ween 


ooaputer  software. 


laSWSAiCT  Tt  AMS  fCmnaame  mm  wwnm  Imien  one  <e»aer>  *»  Star*  mmwtr" 


i  Umttmtn  sms  Ant ft  Ay  Wart  munM'i 


This  document  is  the  product  specification  establ ishing  the  design 
implementation  of  the  IISS  Configuration  Item  File  Utilities  which 
provide  file  transfer,  file  delete  and  unique  file  naming  services 
to  other  components  of  IISS. 

i  ' .  >  a . 


36  D>ST*,SUTlO*»iAVAltAS‘L'r  »  O'  ASkTAACT 
WUCuaak’A'tO'VMt.MSlTIO  W  I'M  AS  ATT  C  OTIC  USI *k  □ 


22*  haul  O'  tll'MilU  iNO'VIOwai. 

Bavld  L.  Min 


21  ASkTAACT  MCWAlTV  CLASSIFICATION 

Unclassified 


22a  II  J'«OM  xvuilA 
0wA*  Awe  Cm*  i 

113-355-0976 


22c  0"iCI*TMkOk 

sjvu.nc.TC 


00  FORM  1473.  S3  APR 


SO'TiOH  O'  1  AAA  73  it  OSkObkTt 


_ Unclassified 

MCuAlTV  C tAkk '•  *CaT iOA  C 


Integrated  Information  Support  System  (IISS) 

Vol  V  -  Common  Data  Model  Subsystem 

Part  31  -  File  Utilities  Product  Specification 


A  S  D  86  1439 
17  Jul  1986 


Accesion  For 

_  7 _ 

MIS  CRA&I 
OTIC  TAB 

n 

UnannourK  ed 

□ 

j  Justification 

By 

Di..t  ibutioo / 

PS  620141330 
1  November  1985 


PREFACE 


This  product  specification  covers  the  work  performed  under 
Air  Force  Contract  F33615-80-C-5155  ( ICAM  Project  6201).  This 
contract  is  sponsored  by  the  Materials  Laboratory,  Air  Force 
Systems  Command,  Wr ight-Patterson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Gerald  C. 
Shumaker,  ICAM  Program  Manager,  Manufacturing  Technology 
Division,  through  Project  Manager.  Mr.  David  Judson.  The  Prime 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Company.  Schenectady,  New  York,  under  the  direction  of 
Mr.  Alan  Rubenstein.  The  General  Electric  Project  Manager  was 
Mr.  Myron  Hurlbut  of  Industrial  Automation  Systems  Department, 
Albany,  New  York. 

Certain  work  aimed  at  improving  Test  Bed  Technology  has 
been  performed  by  other  contracts  with  Project  6201  performing 
integrating  functions.  This  work  consisted  of  enhancements  to 
Test  Bed  software  and  establ i shment  and  operation  of  Test  Bed 
hardware  and  communications  for  developers  and  other  users. 
Documentation  relating  to  the  Test  Bed  from  all  of  these 
contractors  and  projects  have  been  integrated  under  Project  6201 
for  publication  and  treatment  as  an  integrated  set  of  documents. 
The  particular  contributors  to  each  document  are  noted  on  the 
Report  Documentation  Page  (DD1473).  A  listing  and  description 
of  the  entire  project  documentation  system  and  how  they  are 
related  is  contained  in  document  FTR620100001 ,  Project  Overview. 

The  subcontractors  and  their  contributing  activities  were 
as  follows: 


TASK  4.2 

Subcontractors  Role 

Boeing  Military  Aircraft  Reviewer. 

Company  ( BMAC ) 

D.  Appleton  Company 
(DACOM) 


General  Dynamics/ 
Ft.  Worth 


Responsible  for  IDEF  support, 
state-of-the-art  literature 
search. 

Responsible  for  factory  view 
function  and  information 
models . 


i  i  i 
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Subcontractors 

Illinois  Institute  of 
Technology 

North  American  Rockwell 
Northrop  Corporation 

Pritsker  and  Associates 
SofTech 


Role 

Responsible  for  factory  view 
function  research  (IITRI) 
and  information  models  of 
small  and  medium-size  business. 

Reviewer . 

Responsible  for  factory  view 
function  and  information 
models . 

Responsible  for  IDEF2  support. 
Responsible  for  IDEFO  support. 


TASKS  4.3  -  4.9  (TEST  BED) 

Subcontractors  Role 

Boeing  Military  Aircraft  Responsible  for  consultation  on 

Company  (BMAC)  applications  of  the  technology 

and  on  IBM  computer  technology. 


Computer  Technology 
Associates  (CTA) 


Control  Data  Corporation 
(CDC) 


Assisted  in  the  areas  of 
communications  systems,  system 
design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager. 

Responsible  for  the  Common  Data 
Model  (CDM)  implementation  and 
part  of  the  CDM  design  (shared 
with  DACOM). 


D.  Appleton  Company  Responsible  for  the  overall  CDM 

(DACOM)  Subsystem  design  integration 

and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 
(shared  with  CDC).  DACOM  also 
developed  the  Integration 
Methodology  and  did  the  schema 
mappings  for  the  Application 
Subsystems . 
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Subcontractors 


Role 


Digital  Equipment 
Corporation  (DEC) 


McDonne 11  Douglas 
Automation  Company 
(McAuto) 


Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  computer  systems 
operation . 

Responsible  for  the  support  and 
enhancements  to  the  Network 
Transaction  Manager  Subsystem 
during  1984/1985  period. 


On-Line  Software 
International  (OSI) 


Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 
IBM. 


Rath  and  Strong  Systems 
Products  (RSSP)  (In  1985 
became  McCormack  &  Dodge) 


Sof Tech ,  Inc . 


Software  Performance 
Engineering  (SPE) 


Structural  Dynamics 
Research  Corporation 
(SDRC) 


Responsible  for  assistance  in 
the  implementation  and  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 

Responsible  for  the  design  and 
implementation  of  the  Network 
Transaction  Manager  (NTM)  in 
1981/1984  period. 

Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 

Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems . 


Other  prime  contractors  under  other  projects  who  have 
contributed  to  Test  Bed  Technology,  their  contributing 
activities  and  responsible  projects  are  as  follows: 


Contractors 


ICAM  Project  Contributing  Activities 


Boeing  Military 
Aircraft  Company 
(BMAC) 


1701 ,  2201 ,  Enhancements  for  IBM 
2202  node  use.  Technology 

Transfer  to  Integrated 
Sheet  Metal  Center 
( I SMC) . 
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Contractors 

XCAM  Pro.iect 

Contributing  Activities 

Control  Data 
Corporation  (CDC) 

1502,  1701 

IISS  enhancements  to 
Common  Data  Model 
Processor  (CDMP). 

D.  Appleton  Company 
(DACOM) 

1502 

IISS  enhancements  to 
Integration  Methodology. 

General  Electric 

1502 

Operation  of  the  Test 
Bed  and  communications 
equipment . 

Hughes  Aircraft 

Company  (HAC) 

1701 

Test  Bed  enhancements. 

Structural  Dynamics 
Research  Corporation 
(SDRC) 

1502,  1701, 
1703 

IISS  enhancements  to 
User  Interface/Virtual 
Terminal  Interface 
(UI/VTI ) . 

Systran 

1502 

Test  Bed  enhancements . 
Operation  of  Test  Bed. 
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SECTION  1 
SCOPE 


1 . 1  Ident i f i cat i on 


This  specification  establishes  the  design  of  the  "File 
Utilities  Function",  one  of  the  major  functions  of  the 
Configuration  Item  "Precompiler"  to  be  built  and  formally 
accepted  by  the  ICAM  Program  Office.  This  Cl  constitutes  one  of 
the  subsystems  of  the  Common  Data  Model  Processor  (CDMP). 

1 . 2  Functional  Summary 

The  purpose  of  this  Computer  Program  Configuration  Item 
(CPCI)  is  to  provide  file  handling  capabilities  to  modules  of 
the  CDMP  for  file  create,  open,  naming,  close,  delete,  send  and 
receive . 

The  following  functions  will  be  performed  by  the  file 
utilities  CPCI  by  these  modules: 

1.  The  module  CDDV1  will  open,  close  and  delete  a  file 
when  called.  This  module  uses  a  FORTRAN  subroutine  to 
do  the  file  manipulation. 

2.  The  module  CDF01  will  provide  a  unique  name  for  a  file 
when  given  a  host  name.  These  files  are  used  as 
temporary  results  files  from  query  processors, 
aggregators,  and  conceptual  to  external  transformers . 

3.  The  module  CDRF1  will  provide  a  receive  file  function 
when  given  a  file  by  the  file  send  function  (CDSF1). 

It  receives  file  characteristics  and  instructions  and 
returns  file  completion  information. 

4.  The  module  CDSF1  provides  a  file  send  function.  This 
function  transfers  files  from  host  to  host  by  receiving 
file  characteristics  and  operating  instructions.  This 
module  passes  control  to  the  file  receive  function 
(CDRF1 ) . 
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SECTION  2 
DOCUMENTS 


2 . 1  Reference  Documents 

1.  I CAM  Documentat i on  Standards :  IDS15012000A ,  28 

December  1981. 

2.  D.  Appleton  Co..  CDM  Administrators  Manual: 
UM620141000.  March  1984. 

3.  D.  Appleton,  Co.,  CDM1-IDEF,  Model  of  the  Common  Data 
Model ;  CCS620141000,  15  May  1985. 

4.  D.  Appleton  Co.,  Computer  Program  Development 
Specification  (PS)  for  I CAM  Integrated  Support  System 
( IISS)  Configuration  Item:  NDML  Precompiler ; 
DS620141200,  October  1984. 

5.  D.  Appleton  Co.,  Embedded  NDML  Programmer ' s  Reference 

Manual:  PRM620141200 ,  March  1985. 

6.  Softech,  Inc.,  NTM  Programmer ' s  Guide:  UM620140001 , 
July  1984. 

7.  Control  Data  Corporation,  Computer  Development 
Specification  (PS )  for  I CAM  Integrated  Support  System 
( IISS )  Conf i gurat i on  Item:  NDDL  Command  Processor : 
DS620141 100 ,  June  1985. 

2.2  Terms  and  Abbreviations 


Attribute  Use  Class :  ( AUC ) 

Conceptual  Schema:  (CS) 

Common  Data  Model  Processor :  ( CDMP ) 

Common  Data  Model :  (CDM)  Describes  common  data  application 
process  formats,  form  definitions,  etc.  of  the  IISS  and  includes 
conceptual  schema,  external,  internal  schemas,  and  schema 
transformation  operators. 

Data  Field:  (DF)  An  element  of  data  in  the  external 
schema.  It  is  by  this  name  that  an  NDML  programmer  references 
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data. 


Database  Management  System:  (DBMS) 

Distributed  Request  Supervisor:  (DRS)  This  IISS  CDM 
subsystem  configuration  item  controls  the  execution  of 
distributed  NDML  queries  and  non  distributed  updates. 

Domain :  A  logical  definition  of  legal  attribute  class 

values . 

Domain  Constraint:  Predicate  that  applies  to  a  single 
domain . 

External  Schema:  (ES) 

Forms :  Structured  views  which  may  be  imposed  on  windows  o: 
other  forms.  A  form  is  composed  of  fields  where  each  field  is 
form,  item,  or  window. 

Forms  Processor:  ( FP )  A  set  of  callable  execution  time 
routines  available  to  an  application  program  for  form 
processing . 

Internal  Schema:  (IS) 

Integrated  Information  Support  System:  (IISS)  A  test 
computing  environment  used  to  investigate,  demonstrate  and  test 
the  concepts  of  information  management  and  information 
integration  in  the  context  of  Aerospace  Manufacturing.  The  IISS 
addresses  the  problems  of  integration  of  data  resident  on 
heterogeneous  databases  supported  by  heterogeneous  computers 
interconnected  via  a  local  Area  Network. 

Mapping :  The  correspondence  of  independent  objects  in  two 

schemas:  ES  to  CS  or  CS  to  IS. 

Network  Transaction  Manager:  (NTM)  Performs  the 
coordination,  communication  and  housekeeping  functions  required 
to  integrate  the  application  processes  and  system  services 
resident  on  the  various  hosts  into  a  cohesive  system. 

Neutral  Data  Manipulation  Language:  (NDML)  A  language 
developed  by  the  IISS  project  to  provide  uniform  access  to 
common  data,  regardless  of  database  manager  or  distribution 
criteria.  It  provides  distributed  retrieved  and  single  node 
updates . 
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ORACLE :  Relational  DBMS  based  on  the  SQL  (Structured  Query 

Language,  a  product  of  ORACLE  Corp,  Menlo  Park,  CA).  The  CDM  is 
an  ORACLE  database . 

Parcel :  A  sequential  file  containing  sections  source  code 

of  the  input  application  program. 

Request  Processor:  (RP)  A  COBOL  program  that  will  satisfy 
a  retrieval  or  update  NDML  subtransaction  against  a  particular 
Database  Management  System. 

User  Interface:  (UI)  Controls  the  user's  terminal  and 
interfaces  with  the  rest  of  the  system. 

Virtual  Terminal  Interface:  (VTI)  Performs  the  interfacing 
between  different  terminals  and  the  UI .  This  is  done  by 
defining  a  specific  set  of  terminal  features  and  protocols  which 
must  be  supported  by  UI  software  which  constitutes  the  Virtual 
Terminal  Definition.  Specific  terminals  are  then  mapped  against 
the  Virtual  Terminal  software  by  specific  software  modules 
written  for  each  type  of  real  terminal  supported. 
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SECTION  3 


FJ* 


l 


REQUIREMENTS 


3 . 1  Structural  Description 

The  graphic  portrayal  of  this  CPCI  is  included  in  Section 
3.10.  This  chart  shows  the  hierarchial  relationship  of  each 
module  making  up  this  CPCI. 

1.  CDDV1  (OPEN.  CLOSE.  DELETE  function)  modules 
Delete  the  named  file  (FDELET). 

2.  CDF01  (FILE  NAMER  function)  modules 
These  modules  have  no  subordinate. 

3.  CDRF1  (FILE  RECEIVE  FUNCTION)  modules 

Receive  routine  for  file  receive  utility  ( RCVDAT ) . 
Generalized  interface  to  the  file  name  queue  server 
(GENFIL) . 

File  open  routine  for  file  receive  utility  (RCVOPN). 
Closes  files  for  the  file  receive  utility  (RCVCLS). 


4.  CDSF1  (FILE  SEND  FUNCTION)  modules 

Reading  the  file  unit  30  into  buffer  (SNDDAT). 

Open  file  "Filenam"  and  set  file  unit  to  30  (SNDOPN). 
Close  file  unit  30  (SNDCLS). 

3.2  Functional  Flow 


This  CPCI  implementes  the  logic  defined  in  the  Development 
Specification  for  this  CPCI.  Details  of  inputs/outputs  and 
relationships  between  modules  are  found  in  Section  3.10. 

This  CPCI  has  been  designated  to  operate  in  a  batch  or 
interactive  mode.  It  must  operate  in  the  system  environment 
established  for  IISS;  that  is,  the  Network  Transaction  Manager, 
the  commmuni cat ions  and  the  CDMP.  Currently,  on  the  module 
CDF01  (File  Namer)  has  a  VAX  dependency.  This  is  due  to  the 
module  creating  only  VAX  file  names. 
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3.3  Interfaces 


The  diagrams  in  Section  3.3.1  depict  the  interface  of  File 
Utilities  with  other  CPCI ' s . 

3.3.1  Inputs /Outputs 

The  following  information  depicts  the  inputs  and  outputs  of 
each  module  in  this  CPCI. 


MODULE:  CDDV1 


+  - 

1 

1 

Requesting 

Process 

-+ 
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OPEN 

+  -- 
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CDDV1 

PS41330 
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DELETE 
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1 

1 

+- 

-+ 

-+ 

The  file  manipulation  module,  CDDV1 ,  receives  a  request  to 
open,  close,  or  delete  a  file  from  a  requesting  process. 

MODULE :  CDF01 


+ - +  + - +  NEXT 

I  REQUESTING  I  FILE  NAME  REQUEST  I  FILE  I  NAME  + - + 

I  PROCESS  + - +  NAMER  + - +  PERMANENT  I 

I  + - +  CDF01  + - +  FILE  I 

I  I  FILE  NAMES  &  STATUS  I PS41330 1  LAST  I  I 

II  II  NAME  + - + 

+ - +  + - +  USED  "LAST  FILE 

NAME  USED" 


A  requesting  process  sends  File  Name  request  in  the  form  of 
a  message  to  the  File  Name  queue  server.  After  generating  the 
next  group  of  names,  the  File  Namer  sends  a  reply  message  with  a 
status  to  the  requesting  process.  The  file  “LAST  FILE  NAME 
USED"  is  assigned  for  each  host. 
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MODULE:  CDRF1  &  CDS FI 


-+ 

1  FILE 

1  TRANSFER 

1  REQUEST 

+  - 

1 

1 

i 

-  -  '  “  “ 

-+ 

+- 

“  — 

REQUESTING 

FILE 

1 

ACKNOWLEDGE 

1 

FILE 

PROCESS 

-  1 

SEND 

1 

DATA  RECORDS 

1 

RECEIVE 

1  COMPLETION 

1  STATUS 

1 

1 

CDS  FI 

1 

1 

COMPLETION 

0  STATUS 

1 

1 

CDRF1 

1 

1  _ 

I 

1 

+  - 

1 

-+ 

1 

+- 

The  File  Transfer  Cl  is  composed  of  two  functional 
components.  File  Send  and  File  Receive. 

A  requesting  process  sends  a  File  Transfer  message  to  the 
File  Send  at  the  host  where  the  original  file  to  be  transmitted 
resides.  The  File  Send  then  sends  an  initiation  message  to  the 
File  Receive  at  the  host  where  the  file  is  to  be  created.  After 
receiving  acknowledgement  from  File  Receive  the  File  Send  reads 
the  source  file  and  creates  messages  containing  the  file  data. 

It  transmits  these  messages  to  the  File  Receive  where  they  are 
reconstructed  into  a  new  file.  When  the  file  transfer  is 
completed.  File  Send  notifies  the  requesting  process. 

3.4  Program  Interrupts 
Hot  applicable  to  this  CPCI . 

3 . 5  Timing  and  Sequencing  Description 

This  CPCI  is  activated  for  each  file  called  for  by  any 
module  or  subsystem  under  the  common  data  model  processor 
.  (CDMP).  The  modules  under  this  CPCI  are  activated  individually 

|  by  the  requesting  processes. 

3.6  Special  Control  Features 
Not  applicable  to  this  CPCI. 
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3.7  Storage  Allocation 

3.7.1  Database  Definition 

Not  applicable  to  this  CPCI. 

3. 7. 1.1  File  Description 

One  permanent  file  has  been  defined  for  this  CPCI.  This 
file  is  used  by  the  file  namer  “CDF01“  as  the  "LAST  FILE  NAME 
USED"  This  file  is  used  to  periodically  record  the  last  file 
name  assigned  to  each  host.  It  may  also  use  temporary  scratch 
files  for  such  things  as  input  and  results. 

3. 7. 1.2  Table  Description 

All  tables  used  by  this  CPCI  have  been  defined  by  the 
Development  Specification  for  this  CPCI. 

3. 7. 1.3  Item  Description 

Not  applicable  to  this  CPCI. 

3.8  Object  Code  Creation 

The  object  code  for  this  CPCI  will  be  created  by  the  system 
integration  team  using  defined  IISS  Software  Configuration 
Management  procedures.  This  CPCI  will  use  the  COBOL  and  FORTRAN 
language  compilers. 

3.9  Adaptation  Data 

This  CPCI  has  been  using  ANSI  COBOL  and  FORTRAN  languages . 
The  intent  was  to  provide  a  transportable  system.  Any  system 
environment  supporting  these  languages,  a  virtual  memory 
management  schema,  the  COMM  and  NTM  subsystems  of  IISS  and  the 
ORACLE  Database  Management  System  should  be  able  to  support  this 
CPCI.  Every  possible  attempt  has  been  made  to  localize  and 
identify  any  machine  or  environment  dependent  modules  through 
the  original  design  of  the  IISS  and  application  of  Configuration 
Management  Procedures . 

3.10  Detail  Design  Description 

The  following  sections  have  been  computer  generated  for 
this  CPCI. 
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3.10.1  Main  Program  List 

The  following  is  a  list  of  all  "Main  Programs"  which 
are  modules  that  are  not  called  by  any  other  module  being 
documented  here.  These  modules  are  either  program  entry  points 
or,  if  they  are  hooked  into  another  set  of  programs  via 
subroutine  calls,  they  are  the  points  the  external  programs  can 
call  and  therefore  enter  through.  To  differentiate  between  the 
two  types  of  entry  points,  look  at  the  individual  Module 
Documentation  (section  3.10.8)  and  look  at  Module  Type  for  each 
of  the  Main  Program  modules  listed.  Note  whether  the  routine 
is  a  Program,  Subroutine,  or  Function.  If  it  is  a  Program,  it 
is  truly  a  main  program  entry  point.  If  not,  then  it  is  merely 
called  by  other  programs  not  being  documented  here. 
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FILE  UTILITIES  Main  Program  List 
Module  Name  Purpose 

CDDV1  OPEN  CLOSES  AND  DELETES  FILES 

CDF01  THIS  PROGRAM  GENERATES  UNIQUE  FILE  NAMES 

CDFSU  PROGRAM  NAME  FILE  SEND  UTILITY  UNIT 

TEST 

CDRF1  FILE  RECEIVE  FUNCTION 

CDSF1  FILE  SEND  FUNCTION 

DELFIL  ACT  AS  A  GENERALIZED  INTERFACE  TO  THE  FILE 

DELETE  PROGRAM. 
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3.10.2  Module  List 

The  following  is  a  list  of  all  the  modules  being 
documented  here  along  with  their  purpose.  Each  module  has  a 
unique  name,  no  matter  what  language  it  was  written  in. 
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Module 

CDDV1 

CDF01 

CDFSU 

CDRF1 

CDSF1 

DELFIL 

FDELET 

FILXFR 

GENFIL 

RCVCLS 

RCVDAT 

RCVOPN 

SNDCLS 

SNDDAT 


FILE  UTILITIES  Module  List 
Name  Purpose 

OPEN  CLOSES  AND  DELETES  FILES 

THIS  PROGRAM  GENERATES  UNIQUE  FILE  NAMES 

PROGRAM  NAME  FILE  SEND  UTILITY  UNIT 

TEST 

FILE  RECEIVE  FUNCTION 
FILE  SEND  FUNCTION 

ACT  AS  A  GENERALIZED  INTERFACE  TO  THE  FILE 
DELETE  PROGRAM. 

DELETE  THE  NAMED  FILE 

GENERALIZED  INTERFACE  TO  A  FILE  TRANSFER 

GENERALIZED  INTERFACE  TO  THE  FILE  NAME 
QUEUE  SERVER 

CLOSES  FILES  FOR  THE  FILE  RECEIVE  UTILITY 
RECEIVE  ROUITNE  FOR  FILE  RECEVIE  UTILITY 
FILE  OPEN  ROUTINE  FOR  FILE  RECEIVE  UTILITY 
CLOSE  FILE  UNIT  30 

READING  THE  FILE  UNIT  30  INTO  BUFFER 


SNDOPN 


OPEN  FILE  "FILNAM"  AND  SET  FILE  UNIT  TO  30 
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3.10.3  External  Routines  List 

The  following  is  a  list  of  all  routines  or  functions  not 
documented  here  that  are  called  by  modules  that  are  documented 
here.  The  first  caller,  in  alphabetical  order,  is  listed  as 
well.  The  specification  in  which  any  module  is  documented  may 
be  found  in  the  Module  Documentation  Index  (Document  Number 
CM  620100001).  See  section  3.10.6  for  a  list  of  the  modules 
that  call  each  of  these  external  routines. 


■  J  'll 
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FILE  UTILITIES  External  Routines  List 


Module  Name 

First  User 

CDFUNC 

CDSF1 

ERRPRO 

GENFIL 

FORSCLOSE 

FDELET 

FORJOPEN 

SNDOPN 

INITAL 

CDSF1 

INITEX 

CDFSU 

I  SEND 

CDS  FI 

NSEND 

GENFIL 

QSEND 

CDF01 

RCV 

CDF01 

SIGERR 

CDRF1 

TRMNAT 

CDRF1 
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3.10.4  Include  File  List 

The  following  is  a  list  of  all  include  files  called  in 
by  modules  being  documented  here.  Each  include  file  has  a 
unique  name  regardless  of  the  language  being  used.  The  purpose 
of  each  include  file  is  listed  as  well.  A  more  complete 
\  description  of  each  include  file  is  given  in  section  3.10.9. 

IThe  purpose  listed  is  the  one  that  is  in  the  source  code  of  the 
include  file. 

A  purpose  of  "***»  PURPOSE  NOT  FOUND  BY  STRIPPER  •***" 
indicates  that  a  purpose  statement  was  not  written  into  the 
include  file  itself.  The  most  common  reason  for  this  is  that 
}  the  include  file  comes  from  system  libraries  that  were  not 

I  developed  by  the  project,  such  as  'C'  libraries  that  are 

|  provided  with  the  'C'  compiler. 

See  section  3.10.6  for  a  set  of  lists  which  show  all 
the  modules  which  call  in  each  of  these  include  files. 
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File  Name 


ALFABET 

CHKCDM 

ERRCDM 

ERRPRO 

FNAMES 

FSMSG 

SRVRET 

STDRESP 


FILE  UTILITIES  Include  File  List 


Purpose 


LETTERS  CONTAINED  IN  THE  ENGLISH  ALPHABET 

IISS  CDMP  CHECK  STATUS  CODES 

IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

PROCESS  ERROR  INCLUDE  FILE 

STORE  A  GROUP  OF  FILE  NAMES 

MESSAGE  FOR  THE  FILE  SEND  UTILITY 

AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

WS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 
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3.10.5  Where  Include  File  Used  List 

The  following  lists  each  include  file  from  3.10.4  and 
all  the  modules  documented  in  this  specification  which  include 
them.  The  purpose  of  each  module  is  listed  as  well. 
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FILE  UTILITIES  Where- include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


ALFABET 

CDF01  THIS  PROGRAM  GENERATES  UNIQUE  FILE  NAMES 


CHKCDM 

CDDV1  OPEN  CLOSES  AND  DELETES  FILES 

CDF01  THIS  PROGRAM  GENERATES  UNIQUE  FILE  NAMES 

CDFSU  PROGRAM  NAME  FILE  SEND  UTILITY  UNIT 

TEST 

CDRF1  FILE  RECEIVE  FUNCTION 

CDSF1  FILE  SEND  FUNCTION 

DELFIL  ACT  AS  A  GENERALIZED  INTERFACE  TO  THE  FILE 
DELETE  PROGRAM. 

FILXFR  GENERALIZED  INTERFACE  TO  A  FILE  TRANSFER 

GENFIL  GENERALIZED  INTERFACE  TO  THE  FILE  NAME 

QUEUE  SERVER 


ERRCDM 

CDDV1  OPEN  CLOSES  AND  DELETES  FILES 

CDF01  THIS  PROGRAM  GENERATES  UNIQUE  FILE  NAMES 

CDFSU  PROGRAM  NAME  FILE  SEND  UTILITY  UNIT 

TEST 

CDRF1  FILE  RECEIVE  FUNCTION 

CDSF1  FILE  SEND  FUNCTION 

DELFIL  ACT  AS  A  GENERALIZED  INTERFACE  TO  THE  FILE 
DELETE  PROGRAM. 

FILXFR  GENERALIZED  INTERFACE  TO  A  FILE  TRANSFER 

GENFIL  GENERALIZED  INTERFACE  TO  THE  FILE  NAME 

QUEUE  SERVER 


ERRPRO 

CDDV1  OPEN  CLOSES  AND  DELETES  FILES 


3-14 


PS  620141330 
1  November  1965 


FILE  UTILITIES  Where-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


CDF01  THIS  PROGRAM  GENERATES  UNIQUE  FILE  NAMES 

CDFSU  PROGRAM  NAME  FILE  SEND  UTILITY  UNIT 

TEST 

CDRF1  FILE  RECEIVE  FUNCTION 

CDSF1  FILE  SEND  FUNCTION 

DELFIL  ACT  AS  A  GENERALIZED  INTERFACE  TO  THE  FILE 
DELETE  PROGRAM. 

FILXFR  GENERALIZED  INTERFACE  TO  A  FILE  TRANSFER 

GENFIL  GENERALIZED  INTERFACE  TO  THE  FILE  NAME 

QUEUE  SERVER 


FNAMES 

CDF01  THIS  PROGRAM  GENERATES  UNIQUE  FILE  NAMES 

GENFIL  GENERALIZED  INTERFACE  TO  THE  FILE  NAME 
QUEUE  SERVER 


FSMSG 

CDRF1  FILE  RECEIVE  FUNCTION 

CDSF1  FILE  SEND  FUNCTION 

FILXFR  GENERALIZED  INTERFACE  TO  A  FILE  TRANSFER 


SRVRET 

CDDV1  OPEN  CLOSES  AND  DELETES  FILES 

CDF01  THIS  PROGRAM  GENERATES  UNIQUE  FILE  NAMES 

CDFSU  PROGRAM  NAME  FILE  SEND  UTILITY  UNIT 

TEST 

CDRF1  FILE  RECEIVE  FUNCTION 

CDSF1  FILE  SEND  FUNCTION 

DELFIL  ACT  AS  A  GENERALIZED  INTERFACE  TO  THE  FILE 
DELETE  PROGRAM. 

GENERALIZED  INTERFACE  TO  A  FILE  TRANSFER 


FILXFR 
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FILE  UTILITIES  Where-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


GENFIL  GENERALIZED  INTERFACE  TO  THE  FILE  NAME 
QUEUE  SERVER 


STDRESP 

CDDV1  OPEN  CLOSES  AND  DELETES  FILES 

CDF01  THIS  PROGRAM  GENERATES  UNIQUE  FILE  NAMES 

CDRF1  FILE  RECEIVE  FUNCTION 

CDSF1  FILE  SEND  FUNCTION 

DELFIL  ACT  AS  A  GENERALIZED  INTERFACE  TO  THE  FILE 
DELETE  PROGRAM. 

FILXFR  GENERALIZED  INTERFACE  TO  A  FILE  TRANSFER 
GENFIL  GENERALIZED  INTERFACE  TO  THE  FILE  NAME 
QUEUE  SERVER 
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3.10.6  Where  External  Routine  Used  List 

The  following  lists  each  external  function  or  routine 
listed  in  3.10.3  and  all  the  documented  modules  which  call  it. 
The  purpose  of  each  module  is  listed  as  well. 
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FILE  UTILITIES  Where-external -rout ine-used  List 


System 

Module 


Module 

Name 


Module 

Purpose 


CDFUNC 

CDSF1 

DELFIL 

FILXFR 

GENFIL 


FILE  SEND  FUNCTION 

ACT  AS  A  GENERALIZED  INTERFACE  TO  THE  FILE 
DELETE  PROGRAM. 

GENERALIZED  INTERFACE  TO  A  FILE  TRANSFER 
GENERALIZED  INTERFACE  TO  THE  FILE  NAME 
QUEUE  SERVER 


ERRPRO 

CDDV1 

CDF01 

CDFSU 

CDRF1 

CDSF1 

DELFIL 

FILXFR 

GENFIL 


OPEN  CLOSES  AND  DELETES  FILES 
THIS  PROGRAM  GENERATES  UNIQUE  FILE  NAMES 
PROGRAM  NAME  FILE  SEND  UTILITY  UNIT 

TEST 

FILE  RECEIVE  FUNCTION 
FILE  SEND  FUNCTION 

ACT  AS  A  GENERALIZED  INTERFACE  TO  THE  FILE 
DELETE  PROGRAM. 

GENERALIZED  INTERFACE  TO  A  FILE  TRANSFER 
GENERALIZED  INTERFACE  TO  THE  FILE  NAME 
QUEUE  SERVER 


FORECLOSE 

FDELET 

RCVCLS 

SNDCLS 


FORSOPEN 

FDELET 

RCVOPN 


DELETE  THE  NAMED  FILE 

CLOSES  FILES  FOR  THE  FILE  RECEIVE  UTILITY 
CLOSE  FILE  UNIT  30 


DELETE  THE  NAMED  FILE 

FILE  OPEN  ROUTINE  FOR  FILE  RECEIVE  UTILITY 
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FILE  UTILITIES  Where-external -rout ine-used  List 


System 

Module 

Module 

Module 

Name 

Purpose 

SNDOPN 

OPEN  FILE  "FILNAM“  AND 

SET  FILE  UNIT  TO  30 

INITAL 

CDDV1 

OPEN  CLOSES  AND  DELETES 

1  FILES 

CDF01 

CDRF1 

CDSF1 

THIS  PROGRAM  GENERATES 
FILE  RECEIVE  FUNCTION 
FILE  SEND  FUNCTION 

UNIQUE  FILE  NAMES 

INITEX 

CDFSU 

PROGRAM  NAME 

FILE  SEND  UTILITY  UNIT 

TEST 

I  SEND 

CDSF1 

FILE  SEND  FUNCTION 

FILXFR 

GENERALIZED  INTERFACE  TO  A  FILE  TRANSFER 

NSEND 

CDRF1 

FILE  RECEIVE  FUNCTION 

CDSF1 

FILE  SEND  FUNCTION 

DELFIL 

ACT  AS  A  GENERALIZED  INTERFACE  TO  THE  FILE 
DELETE  PROGRAM. 

GENFIL 

GENERALIZED  INTERFACE  TO  THE  FILE  NAME 
QUEUE  SERVER 

QSEND 

CDF01 

THIS  PROGRAM  GENERATES  UNIQUE  FILE  NAMES 
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FILE  UTILITIES  Where-external-routine-used  List 

System  Module  Module 

Module  Name  Purpose 


RCV 

CDDV1  OPEN  CLOSES  AND  DELETES  FILES 

CDF01  THIS  PROGRAM  GENERATES  UNIQUE  FILE  NAMES 

CDRF1  FILE  RECEIVE  FUNCTION 

CDSF1  FILE  SEND  FUNCTION 

FILXFR  GENERALIZED  INTERFACE  TO  A  FILE  TRANSFER 

GENFIL  GENERALIZED  INTERFACE  TO  THE  FILE  NAME 

QUEUE  SERVER 


SIGERR 

CDRF1  FILE  RECEIVE  FUNCTION 

CDSF1  FILE  SEND  FUNCTION 


TRMNAT 

CDDV1  OPEN  CLOSES  AND  DELETES  FILES 

CDF01  THIS  PROGRAM  GENERATES  UNIQUE  FILE  NAMES 

CDFSU  PROGRAM  NAME  FILE  SEND  UTILITY  UNIT 

TEST 

CDRF1  FILE  RECEIVE  FUNCTION 

CDSF1  FILE  SEND  FUNCTION 
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3.10.7  Main  Program  Paris  List 


The  following  lists  each  Main  Program  listed  in  3.10.1 
and  all  the  modules  which  are  called  either  by  that  module 
itself  or  by  any  of  the  documented  modules  which  it  calls.  It 
is  possible  for  a  non-main  module  to  be  listed  more  that  once 
if  it  is  called  by  multiple  modules.  The  called  modules,  in 
this  case  known  as  program  parts,  are  marked  as  to  whether 
they  are  documented  here.  If  so,  the  phrase  "well-defined 
module"  appears  by  the  module  name,  if  not  it  is  an  "external 
"routine".  The  Purpose  of  the  Main  Program  module  is  listed 
as  well. 
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FILE  UTILITIES  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


Purpose-- .OPEN  CLOSES  AND  DELETES  FILES 


CDDV1 

ERRPRO 
FDELET 
FORSCLOSE 
FORSOPEN 
INITAL 
RCV 

TRMNAT 


External  routine 
Well-defined  module 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
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FILE  UTILITIES  Main  Program  Parts  List 


Main  Pgm  Module 
Name  Name 


Module 

Type 


CDF01 


ERRPRO 

INITAL 

QSEND 

RCV 

TRMNAT 


Purpose-- > THIS  PROGRAM  GENERATES  UNIQUE 
FILE  NAMES 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
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FILE  UTILITIES  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


CDFSU  Purpose — 

CDFUNC 

ERRPRO 

FILXFR 

INITEX 

I  SEND 

RCV 

TRMNAT 


PROGRAM  NAME  FILE  SEND 

UTILITY  UNIT  TEST 
External  routine 
External  routine 
Well-defined  module 
External  routine 
External  routine 
External  routine 
External  routine 
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FILE  UTILITIES  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

CDRF1 

Purpose-- 

>  FILE  RECEIVE  FUNCTION 

CDFUNC 

External  routine 

ERRPRO 

External  routine 

FORSCLOSE 

External  routine 

FORSOPEN 

External  routine 

GENFIL 

Well-defined  module 

INITAL 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 

RCVCLS 

Well-defined  module 

RCVDAT 

Well-defined  module 

RCVOPN 

Well-defined  module 

SIGERR 

External  routine 

TRMNAT 

External  routine 

» 

> 
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FILE  UTILITIES  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


Purpose—  >  FILE  SEND  FUNCTION 


CDSF1 

CDFUNC 
ERRPRO 
FORSCLOSE 
F0R$0PEN 
INITAL 
I  SEND 
NSEND 
RCV 
SIGERR 
SNDCLS 
SNDDAT 
SNDOPN 
TRMNAT 


External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
External  routine 
Well-defined  module 
Well-defined  module 
Well-defined  module 
External  routine 
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FILE  UTILITIES  Main  Program  Parts  List 


Main  Pgm  Module 
Name  Name 


Module 

Type 


DELFIL  Purpose-- 

CDFUNC 

ERRPRO 

FDELET 

FORSCLOSE 

FORSOPEN 

NSEND 


ACT  AS  A  GENERALIZED  INTERFACE 
TO  THE  FILE  DELETE  PROGRAM. 
External  routine 
External  routine 
Well-defined  module 
External  routine 
External  routine 
External  routine 
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3.10.8  Module  Documentation 

The  following  documentation  describes  information 
which  is  specific  to  each  individual  module  being  documented 
in  this  specification  as  listed  in  section  3.10.2.  It 
provides  a  compact  way  of  getting  information  that  would  be 
otherwise  buried  within  each  module's  source  code. 

The  specific  items  in  this  module  documentation  have  the 
following  meanings: 


NAME: 


Name  of  program  Module. 


PURPOSE : 


Purpose  of  Module  as  detailed  in  the 
source  code. 


LANGUAGE : 


C 

l 

MODULE  TYPE : 


Programming  language  source  code  is 
written  in. 

The  choices  are: 

VAX- 11  FORTRAN 

( I/S-l  Workbench  'C') 
VAX- 11  COBOL 

Whether  a  Program,  Subroutine,  or 
Function . 


SOURCE  FILE: 

SOURCE  FILE  TYPE: 


HOST: 


SUBSYSTEM : 
SUBDIRECTORY: 

DOCUMENTATION  GROUP: 


Name  of  Source  File  from  file 
specification. 

Source  File  Extension  from  file 
specification. 

Whether  this  is  a  host -dependent 
routine  (VAX  or  IBM)  or  blank  if 
hos  t - i ndependent . 

IISS  sub-system  this  file  resides  in. 

Sub-directory  of  that  subsystem  in 
which  this  file  resides. 

Name  of  documentation  group  of  which 
this  source  file  is  a  member. 
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from  the  source  code. 

ARGUMENTS:  The  arguments  with  which  this  routine 

is  called  if  it  is  a  Subroutine  or  a 
Function. 


INCLUDE  FILES:  A  list  of  all  the  files  that  are 

included  into  this  module  as  well  as 
their  purposes. 


ROUTINES  CALLED:  Subroutines  or  Functions,  either 

documented  or  external,  called  by 
this  module,  if  any. 


CALLED  DIRECTLY  BY:  The  documented  routines  which  call 

this  module,  if  any. 

USED  IN  MAIN  PROGRAM(S):  The  documented  Main  Programs  which 

contain  this  module  in  their  parts 
list  according  to  the  list  in  section 
3.10.7. 


PS  620141330 
1  November  1985 


FILE  UTILITIES  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


CDDV1 

OPEN  CLOSES  AND  DELETES  FILES 

VAX- 11  COBOL 

PROGRAM 

CDDV1 

.COB 

VAX 

CDM 

PS41330 


DESCRIPTION: 


THIS  IS  A  MAIN  PROGRAM  WHICH  CALLS  A 
FORTRAN  77  SUBROUTINE  TO  OPEN  AND  CLOSE 

A  FILE  BY  THE  GIVEN  NAME  AND  DELETE  IT.  THIS  IS  THE  MOST 
MACHINE  INDEPENDENT  METHOD  FOR  DELETING  FILES  FOUND, 
mod  for  rel  2.0  standard  error  handling, 
pic  9(5)  comp  message  data  length  parm. 
also,  do  not  need  to  send  a  reply  back. 


INCLUDE  FILES: 


ERRCDM 

CHKCDM 

SRVRET 

STDRESP 

ERRPRO 


-  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

-  IISS  CDMP  CHECK  STATUS  CODES 

-  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

-  WS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 

-  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


FDELET  -  DELETE  THE  NAMED  FILE 

ERRPRO 

INITAL 


PS  620141330 
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RCV 

TRMNAT 
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FILE  UTILITIES  Module  Documentation 


NAME:  CDF01 

PURPOSE:  THIS  PROGRAM  GENERATES  UNIQUE  FILE  NAMES 

LANGUAGE:  VAX- 11  COBOL 

MODULE  TYPE :  PROGRAM 

SOURCE  FILE:  CDF01 

SOURCE  FILE  TYPE:  .COB 

HOST:  VAX 

SUBSYSTEM :  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41330 
DESCRIPTION: 


-  CDF01  IS  A  QUEUE  SERVER  RESIDENT  ON  ONLY  ONE  PLACE 
IN  THE  TEST  BED.  WHEN  CALLED  WITH  A  HOST  ID,  IT  WILL 
REPLY  WITH  THE  NEXT  FILE  NAME  TO  USE  FOR  TEMPORARY 
RESULTS  OF  QUERY  PROCESSORS , AGGREGATORS ,  AND 
THE  C  TO  E  TRANSFORMS,  ETC. 

MOD  FOR  2.0 

SEND  OUT  MANY  FILE  NAMES  ON  1  REQUEST 
WRAP  FILE  NUMBERS  AROUND  AND  INCREMENT  LETTER 
SAVE  FILE  NAMES  USED  PERIODICALLY  ON  A 
SAVE-FILE 


INCLUDE  FILES: 


ERRCDM 

CHKCDM 

FNAMES 

STDRESP 

SRVRET 

ALFABET 

ERRPRO 


IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 
IISS  CDMP  CHECK  STATUS  CODES 
STORE  A  GROUP  OF  FILE  NAMES 
WS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 
AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 
LETTERS  CONTAINED  IN  THE  ENGLISH  ALPHABET 
PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


PS  620141330 
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ERRPRO 

INITAL 

RCV 

QSEND 

TRMNAT 
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FILE  UTILITIES  Module  Documentation 


NAME: 
PURPOSE : 


LANGUAGE: 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


CDFSU 

PROGRAM  NAME 

UNIT  TEST 

VAX- 11  COBOL 

PROGRAM 

CDFSU 

.COB 


SUBSYSTEM :  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41330 


FILE  SEND  UTILITY 


DESCRIPTION: 


-  THIS  ROUTINE  WILL  TEST  FILE  SEND  AND 
RECIEVE  UTILITIES.  WHICH  IN  TURN  USE 
FILE  NAMER  AND  FILE  DELETER  UTILITIES. 


INCLUDE  FILES: 


ERRCDM  -  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 
CHKCDM  -  IISS  CDMP  CHECK  STATUS  CODES 
SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


FILXFR  -  GENERALIZED  INTERFACE  TO  A  FILE  TRANSFER 

TRMNAT 

ERRPRO 

INITEX 
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FILE  UTILITIES  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 

HOST: 

SUBSYSTEM : 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41330 


CDRF1 

FILE  RECEIVE  FUNCTION 

VAX- 11  COBOL 

PROGRAM 

CDRF1 

.COB 

VAX 

CDM 


% 


kt  ’ 


>;• 


DESCRIPTION: 

-  THE  FILE  RECIEVE  FUNCTION  ACCEPTS  FILES  FROM 
FILE  SEND  FUNCTION.  IT  RECEIVES  FILE 
CHARACTERISTICS  AND  OPERATING  INSTRUCTIONS 
FROM  THE  FILE  SEND  PROCESS.  FILE  RECEIVE 
PASSES  COMPLETION  INFORMATION  TO  THE  FILE 
SEND  FUNCTION. 

mod  rel  2.0  -  must  call  "GENFIL"  to  determine  name 
of  results  file,  use  of  9(5)  comp  data-length 
USE  STANDARD  ERROR  HANDLING  AND  ALLOW 
FOR  RESULTS  FILE  NAME  TO  BE  BLANK. 


$ 


INCLUDE  FILES: 

ERRCDM  -  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

CHKCDM  -  IISS  CDMP  CHECK  STATUS  CODES 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

FSMSG  -  MESSAGE  FOR  THE  FILE  SEND  UTILITY 

STDRESP  -  WS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


INITAL 

RCV 
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SIGERR 

NSEND 

RCVDAT  -  RECEIVE  ROUITNE  FOR  FILE  RECEVIE  UTILITY  ** 

TRMNAT 

ERRPRO 

GENFIL  -  GENERALIZED  INTERFACE  TO  THE  FILE  NAME  QUEUE 

SERVER 

RCVOPN  -  FILE  OPEN  ROUTINE  FOR  FILE  RECEIVE  UTILITY  ** 

RCVCLS  -  CLOSES  FILES  FOR  THE  FILE  RECEIVE  UTILITY  ** 
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FILE  UTILITIES  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


CDSF1 

FILE  SEND  FUNCTION 

VAX- 11  COBOL 

PROGRAM 

CDS  FI 

-COB 

VAX 

CDM 

PS41330 


-  THE  FILE  SEND  FUNCTION  TRANSFERS  FILES  FROM 
HOST  TO  HOST.  THE  FILE  SEND  RECEIVES  FILE 
CHARACTERISTICS  AND  OPERATING  INSTRUCTIONS 
FROM  A  REQUESTING  PROCESS.  IT  IN  TURN 
PASSES  CONTROL  INFORMATION  TO  A  FILE 
RECEIVE  FUNCTION. 

mod  rel  2.0  output  file  name  does  not  come  from  the  DRS 

USE  THE  " CDFUNC "  ROUTINE  TO  DETERMINE 

name  of  file  receive,  use  9(5)  COMP  data  lenght 


INCLUDE  FILES: 


CHKCDM 

ERRCDM 

SRVRET 

FSMSG 

STDRESP 

ERRPRO 


IISS  CDMP  CHECK  STATUS  CODES 

IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

MESSAGE  FOR  THE  FILE  SEND  UTILITY 

WS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 

PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


INITAL 

RCV 

CDFUNC 
I  SEND 
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SNDDAT 

NSEND 

SIGERR 

TRMNAT 

ERRPRO 

SNDOPN 

SNDCLS 


READING  THE  FILE  UNIT  30  INTO  BUFFER 


OPEN  FILE  “FILNAM”  AND  SET  FILE  UNIT  TO  30  *  * 
CLOSE  FILE  UNIT  30  ** 
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FILE  UTILITIES  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 

DESCRIPTION: 


DELFIL 

ACT  AS  A  GENERALIZED  INTERFACE  TO  THE 
FILE  DELETE  PROGRAM. 

VAX- 11  COBOL 

SUBROUTINE 

DELFIL 

.COB 

VAX 

CDM 

PS41330 


THE  PURPOSE  OF  THIS  ROUTINE  IS  TO  ACT  AS  A 
GENERALIZED  INTERFACE  TO  THE  FILE  DELETE 
PROGRAM  ON  THE  APPROPRIATE  HOST. 

MOD  FOR  RELEASE  2.0  :  USE  CDFUNC  ROUTINE. 


DON'T  WAIT  FOR  ft  REPLY  FRO  Q-SERVER. 
if  request  is  on  host,  use  fdelet 
directly 

use  standard  error  handling 
IF  HOST  INPUT  IS  BLANK,  USE  CURRENT  HOST 
AND  RETURN  IT  TO  THE  CALLER. 


ARGUMENTS : 


FILE-HOST  «=  DSPLY  [XXX] 
OLD-FILE-NAME  -  DSPLY  [X(30)l 


INCLUDE  FILES: 


CHKCDM 

ERRCDM 

STDRESP 

SRVRET 

ERRPRO 


IISS  CDMP  CHECK  STATUS  CODES 
IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 
WS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 
AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 
PROCESS  ERROR  INCLUDE  FILE 
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ROUTINES  CALLED: 


FDELET  -  DELETE  THE  NAMED  FILE 

CDFUNC 

NSEND 

ERRPRO 
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FILE  UTILITIES  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


FDELET 

DELETE  THE  NAMED  FILE 

VAX- 11  FORTRAN 

SUBROUTINE 

FDELET 

.FOR 

VAX 

CDM 

PS41330 


ARGUMENTS : 


FNAME  -  CHAR 
IOSTA  =  1*4 


ROUTINES  CALLED: 


FORSCLOSE 

FORSOPEN 


CALLED  DIRECTLY  BY: 


CDDV1  -  OPEN  CLOSES  AND  DELETES  FILES 

DELFIL  -  ACT  AS  A  GENERALIZED  INTERFACE  TO  THE  FILE 

DELETE  PROGRAM. 


USED  IN  MAIN  PROGRAM ( S ) : 


CDDV1  -  OPEN  CLOSES  AND  DELETES  FILES 

DELFIL  -  ACT  AS  A  GENERALIZED  INTERFACE  TO  THE  FILE 

DELETE  PROGRAM. 
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FILE  UTILITIES  Module  Documentation 


NAME: 

PURPOSE: 

LANGUAGE : 

MODULE  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


FILXFR 

GENERALIZED  INTERFACE  TO  A  FILE  TRANSFER 

VAX- 11  COBOL 

SUBROUTINE 

FILXFR 

-COB 


SUBSYSTEM:  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41330 


DESCRIPTION: 


-  THIS  ROUTINE  WILL  ACCEPT  USER  INPUTS  AND 
DETERMINE  THE  CORRECT  FILE  SEND  TO  INTERFACE 
WITH.  IT  IS  ASSUMED  THE  FILE  TO  BE 
TRANSFERRED  IS  ON  HOST. 


FIRST  LOOK  UP  THE  NAME  OF  THE  FILE  SENDER  ON  THIS  HOST. 
THEN  SET  UP  THE  INPUT  MESSAGE  TO  THE  FILE  SENDER. 

IF  THE  USER  DID  NOT  WANT  TO  WAIT,  RETURN.  IF  HE  DID 
WAIT  FOR  THE  REPLY  AND  RETURN  THE  RET-STATUS . 


ARGUMENTS : 


SOURCE-HOST  -  DSPLY  [XXX] 
SOURCE-FILE  *  DSPLY  [X(30)j 
FILE-REC-SIZE  -  DSPLY  [S9(5)] 
DEST-HOST  -  DSPLY  [XXX] 

WAIT-FLAG  *  DSPLY  [9] 
BINARY-NATIVE-FLAG  *  DSPLY  [X] 
DESTINATION-FILE  *  DSPLY  [X(30>] 
RECS-SENT  =  DSPLY  [9(6)3 
RET-STATUS  =  DSPLY  [X(5)3 


INCLUDE  FILES: 


SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

ERRCDM  -  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 
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CHKCDM  -  IISS  CDMP  CHECK  STATUS  CODES 

FSMSG  -  MESSAGE  FOR  THE  FILE  SEND  UTILITY 

STDRESP  -  WS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 


ROUTINES  CALLED: 


CDFUNC 
I  SEND 
RCV 

ERRPRO 


CALLED  DIRECTLY  BY: 


CDFSU  -  PROGRAM  NAME  FILE  SEND  UTILITY  UNIT  TEST 


USED  IN  MAIN  PROGRAM(S): 


CDFSU  -  PROGRAM  NAME  FILE  SEND  UTILITY  UNIT  TEST 
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FILE  UTILITIES  Module  Documentation 


NAME:  GENFIL 

PURPOSE:  GENERALIZED  INTERFACE  TO  THE  FILE  NAME 

QUEUE  SERVER 
LANGUAGE:  VAX- 11  COBOL 

MODULE  TYPE:  SUBROUTINE 

SOURCE  FILE:  GENFIL 

SOURCE  FILE  TYPE:  .COB 

HOST :  VAX 

SUBSYSTEM:  CDM 

SUBDIRECTORY: 

DOCUMENTATION  GROUP:  PS41330 
DESCRIPTION: 


THE  PURPOSE  OF  THIS  ROUTINE  IS  TO  ACT  AS  A 
GENERALIZED  INTERFACE  TO  THE  FILE  NAME 
QUEUE  SERVER. 

mod  for  release  2.0  to  return  a  ret-status 

ALSO  WILL  USE  CDFUNC  TO  DETERMINE  AP . 
WILL  ASK  FOR  AND  RECEIVE  A  BLOCK  OF  20  NAMES 
AND  HAND  THEM  OUT  TO  A  CALLER  1  AT  A  TIME. 

IF  INUT-HOST  NAME  IS  BLANK,  THEN  USE  THE 
CURRENT  HOST  AND  PASS  IT  BACK  TO  THE  CALLER. 


ARGUMENTS : 


FILE-HOST  »  DSPLY  [XXX] 
NEW-FILE-NAME  =  DSPLY  [X(30)l 
RET-STATUS  -  DSPLY  [X(5)3 


INCLUDE  FILES: 


FNAMES  -  STORE  A  GROUP  OF  FILE  NAMES 

CHKCDM  -  IISS  CDMP  CHECK  STATUS  CODES 

ERRCDM  -  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

STDRESP  -  WS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

ERRPRO  -  PROCESS  ERROR  INCLUDE  FILE 
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ROUTINES  CALLED: 

CDFUNC 

NSEND 

RCV 

ERRPRO 


CALLED  DIRECTLY  BY: 


CDRF1 


-  FILE  RECEIVE  FUNCTION 


USED  IN  MAIN  PROGRAM(S) : 


CDRF1 


-  FILE  RECEIVE  FUNCTION 
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FILE  UTILITIES  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM: 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


RCVCLS 

CLOSES  FILES  FOR  THE 

VAX- 11  FORTRAN 

SUBROUTINE 

RCVCLS 

.FOR 

VAX 

CDM 

PS41330 


FILE  RECEIVE  UTILITY 


DESCRIPTION: 


ARGUMENTS : 


FILNAM  «  CHAR 
CLSTAT  =  CHAR 
IOS  -  1*4 


ROUTINES  CALLED: 


FORSCLOSE 


CALLED  DIRECTLY  BY: 


CDRF1  -  FILE  RECEIVE  FUNCTION 

USED  IN  MAIN  PROGRAM(S) : 

CDRF1  -  FILE  RECEIVE  FUNCTION 
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FILE  UTILITIES  Module  Documentation 


NAME :  RCVDAT 

PURPOSE:  RECEIVE  ROUITNE  FOR  FILE  RECEVIE  UTILITY 

LANGUAGE:  VAX- 11  FORTRAN 

MODULE  TYPE:  SUBROUTINE 

SOURCE  FILE :  RCVDAT 

SOURCE  FILE  TYPE:  .FOR 

HOST :  VAX 

SUBSYSTEM :  CDM 

SUBDIRECTORY : 

DOCUMENTATION  GROUP:  PS41330 
DESCRIPTION: 


ARGUMENTS : 


SNDATA  «  CHAR 
NUMREC  «  1*4 

RECLEN  »  1*4 

RECSWR  =  1*4 

WRERR  =  1*4 


CALLED  DIRECTLY  BY: 


CDRF1  -  FILE  RECEIVE  FUNCTION 


USED  IN  MAIN  PROGRAM(S) : 


CDRF1 


-  FILE  RECEIVE  FUNCTION 


PS  620141330 
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FILE  UTILITIES  Module  Documentation 


RCVOPN 

FILE  OPEN  ROUTINE  FOR  FILE  RECEIVE 
UTILITY 

VAX- 11  FORTRAN 
SUBROUTINE 
RCVOPN 
.FOR 
VAX 
CDM 

PS41330 

DESCRIPTION: 


ARGUMENTS : 


FILNAM  =  CHAR 
IOS  -  1*4 

RECLEN  =  1*4 


ROUTINES  CALLED: 


FORSOPEN 


CALLED  DIRECTLY  BY: 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 


CDRF1  -  FILE  RECEIVE  FUNCTION 


USED  IN  MAIN  PROGRAM(S) : 

CDRF1  -  FILE  RECEIVE  FUNCTION 


PS  620141330 
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FILE  UTILITIES  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


SNDCLS 

CLOSE  FILE  UNIT  30 
VAX- 11  FORTRAN 
SUBROUTINE 
SNDCLS 
.FOR 
VAX 
CDM 

PS41330 


ARGUMENTS : 


FILNAM  -  CHAR 
IOS  *  1*4 


ROUTINES  CALLED: 


FORSCLOSE 


CALLED  DIRECTLY  BY: 


CDSF1  -  FILE  SEND  FUNCTION 


USED  IN  MAIN  PROGRAM(S) : 


CDSF1  -  FILE  SEND  FUNCTION 
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FILE  UTILITIES  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY: 
DOCUMENTATION  GROUP: 

DESCRIPTION: 


ARGUMENTS : 

SNDATA  - 

CHAR 

RECLEN  - 

1*4 

RECSRD  - 

1*4 

BUFLEN  - 

1*4 

RDERR  - 

1*4 

EOF  -  I 

*4 

CALLED  DIRECTLY  BY: 


CDSF1  -  FILE  SEND  FUNCTION 

USED  IN  MAIN  PROGRAM(S) : 


CDSF1  -  FILE  SEND  FUNCTION 


SNDDAT 

READING  THE  FILE  UNIT  30  INTO  BUFFER 
VAX- 11  FORTRAN 
SUBROUTINE 
SNDDAT 
.FOR 
VAX 
CDM 

PS41330 
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FILE  UTILITIES  Module  Documentation 


NAME: 

PURPOSE : 

LANGUAGE : 

MODULE  TYPE: 

SOURCE  FILE: 

SOURCE  FILE  TYPE: 
HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 
DOCUMENTATION  GROUP 


SNDOPN 

OPEN  FILE  “FILNAM" 
30 

VAX- 11  FORTRAN 

SUBROUTINE 

SNDOPN 

.FOR 

VAX 

CDM 

:  PS41330 


AND  SET  FILE  UNIT  TO 


DESCRIPTION: 


ARGUMENTS : 


FILNAM  -  CHAR 
IOS  -  1*4 

RECLEN  =  1*4 


ROUTINES  CALLED: 


FORSOPEN 


CALLED  DIRECTLY  BY: 

CDSF1  -  FILE  SEND  FUNCTION 

USED  IN  MAIN  PROGRAM(S) : 

CDSF1  -  FILE  SEND  FUNCTION 


PS  620141330 
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3.10.9  Include  File  Descriptions 

The  following  list  contains  a  purpose  and  description  of 
each  include  file  listed  in  3.10.4  as  specified  in  the  source 
code.  The  language  it  is  written  in  is  also  given. 
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FILE  UTILITIES  Include  File  Description 


FILE  NAME:  ALFABET 

PURPOSE:  LETTERS  CONTAINED  IN  THE  ENGLISH  ALPHABET 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THIS  IS  THE  ENGLISH  ALPHABET,  THE  LETTERS  ARE  USED 
FOR  ASSIGNING  THE  NEXT  UNIQUE  NAME  WHEN  THE 
NUMBERS  RUN  OUT. 


ALFABET . INC 
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FILE  UTILITIES  Include  File  Description 


FILE  NAME:  CHKCDM 

PURPOSE:  IISS  CDMP  CHECK  STATUS  CODES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


CONTAINS  ALL  STATUS  CODES  FOR  THE 
CDMP  MODULES 
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FILE  UTILITIES  Include  File  Description 


FILE  NAME:  ERRCDM 

PURPOSE:  IISS  ERROR  STATUS  CODES  FOR  CDMP  MODULES 

LANGUAGE:  VAX- 11  COBOL 


DESCRIPTION: 


PS  620141330 
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FILE  UTILITIES  Include  File  Description 


FILE  NAME:  ERRPRO 

PURPOSE:  PROCESS  ERROR  INCLUDE  FILE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 
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FILE  UTILITIES  Include  File  Description 
FILE  NAME:  FNAMES 

PURPOSE:  STORE  A  GROUP  OF  FILE  NAMES 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 

CONTAINS  UNIQUE  FILE  NAMES  USED  DURING  PRECOMPILATION 
FNAMES . INC 

STORE  A  GROUP  OF  UNIQUE  FILE  NAMES 
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FILE  UTILITIES  Include  File  Description 
FILE  NAME:  FSMSG 

PURPOSE  MESSAGE  FOR  THE  FILE  SEND  UTILITY 
LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 

MESSAGE  FORMAT  FOR  THE  FILE  SEND  INPUT 
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I 


t 
«' 


$ 

% 


i 

3 

% 


FILE  UTILITIES  Include  File  Description 


FILE  NAME:  SRVRET 

PURPOSE:  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


MODIFIED  11/2/83  TO  INCLUDE  RET-CODE-5 

MODIFIED  1/9/84  TO  INCREASE  ALL  ERROR  CODES  TO  PIC  X(5) 
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FILE  UTILITIES  Include  File  Description 


FILE  NAME:  STDRESP 

PURPOSE:  WS  DEFINITION  FOR  STANDARD  STATUS  VARIABLE 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


THE  STANDARD  'PROCESS  COMPLETE'  MESSAGE 
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3.10.10  Hierarchy  Chari 

The  following  hierarchy  charts  show  the  relationships 
between  all  of  the  modules  mentioned  in  the  above  documentation. 
A  module  may  call  a  subroutine  several  times  within  its  code, 
but  the  call  will  only  be  shown  once  as  a  single  relationship  on 
this  hierarchy  chart.  All  modules  shown  at  the  top  of  the  first 
page  are  considered  Main  Programs  as  described  in  section  3.10.1 
above . 

There  is  an  internal  paging  scheme  as  marked  by  the  numbers 
in  the  upper  right  corner  of  each  page.  An  index  after  the  last 
page  of  the  chart  shows  where  a  routine  and  its  calls  are  first 
defined.  If  a  routine  has  no  page  reference,  it  either  makes  no 
calls  or  is  an  external  routine.  A  continuation  box  on  the  end 
of  a  tree  limb  shows  where  that  the  tree  continues  on  the  page 
numbered  mentioned.  A  number  in  a  box  with  a  routine  name 
points  to  the  page  where  the  routine  is  further  defined  within 
the  hierarchy  tree.  If  there  is  no  number  in  a  box,  the  routine 
either  makes  no  calls  or  is  an  external  routine. 
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1 
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CDDV1 . 2 

CDF01 . 3 

CDFSU . 4 

CDFUNC 

CDRF1 . 5 

CDSF1 . 6 

DELFIL . 7 

ERRPRO 

FDELET . 2 

FILXFR . 4 

FORSCLOSE 
FORSOPEN 
GENFIL . 10 


INITAL 

INITEX 

I  SEND 

NSEND 

QSEND 

RCV 


RCVCLS . 8 

RCVDAT 

RCVOPN . 8 

SIGERR 

SNDCLS . 11 

SNDDAT 

SNDOPN . 11 
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3.11  Program  Listings  Comments 

This  information  is  contained  in  the  Module  Descriptions  in 
section  3.10. 
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SECTION  4 

QUALITY  ASSURANCE  PROVISIONS 


4 • 1  Introduction  and  Def ini t i ons 

"Testing'*  is  a  systematic  process  that  may  be  preplanned 
and  explicitly  stated.  Test  techniques  and  procedures  may  be 
defined  in  advance,  and  a  sequence  of  test  steps  may  be 
specified.  " Debugg i ng "  is  the  process  of  isolation  and 
correction  of  the  cause  of  an  error. 

“Ant i bugging"  is  defined  as  the  phi  1  osophy  of  writing 
programs  in  such  a  way  as  to  make  bugs  less  likely  to  occur  and 
when  they  do  occur,  to  make  them  more  noticeable  to  the 
programmer  and  the  user.  In  other  words,  as  muc h  error  checking 
as  is  practical  and  possible  in  each  routine  should  be 
performed . 

4 . 2  Computer  Programming  Test  and  Evaluation 

The  quality  assurance  provisions  for  test  consists  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  process.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  testing.  These 
tests  are  performed  by  the  design  team.  Structured  design, 
design  walk-through  and  the  incorporation  of  “ant ibugging“ 
facilitate  this  testing  by  exposing  and  addressing  problem  areas 
before  they  become  coded  “bugs." 
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